Prepare to Use IIS with Mart

If you want to use Microsoft Internet Information Services (IIS) as the web server, configure it before deploying Mart Server.

This section contains the following topics

Configure IIS Web Server

Implement SSL for IIS

Configure IIS Web Server

The Mart Server is built using Java technology. Therefore, if you want to connect to Mart through IIS, configure IIS to use the JK ISAPI redirector plugin. Using this plugin, IIS sends servlet and JSP requests to Tomcat.

Note: This procedure describes how to configure IIS 6.0 for Microsoft Windows Server Enterprise 2008. For more information about configuring other versions of IIS for other operating systems, see the respective vendor documentation.

Follow these steps:

  1. Help ensure that Tomcat is working properly. Open a browser and type the following in the Address bar: 
    http://<servername>:18170/MartAdmin

    The default Tomcat home page appears. <servername> is the name of the computer where you have installed Tomcat. 18170 is the default port number where Tomcat is running. If you are using a different port number, use that port number here. In addition, help ensure that the port number you are using is included in the server.xml file. Typically, the server.xml file is available in the <Tomcat_Home>/conf folder.

  2. Install IIS.

    For more information about how to install IIS on Windows Server 2008, see Microsoft documentation.
    Note: Unlike IIS 6, for IIS versions 7, 8, and 10, the following Application Development role services are not installed by default:

    • ASP
    • CGI
    • ISAPI Extensions
    • ISAPI Filters

    To select these role services explicitly while configuring IIS:

    1. Under Server Roles, select Web Server.
    2. Click Add Features.
    3. Next, go to Web Server (IIS) > Role Services.
    4. Under Application Development, select ASP, CGI, ISAPI Extensions, and ISAPI Filters check boxes.
  3. Create a folder, for example Native_IIS on the computer where you have installed IIS. Download the isapi_redirect.dll file for Windows from the Apache Tomcat website and copy to Native_IIS. If the name of the DLL file is not isapi_redirect.dll, rename it.
  4. Create the workers.properties, isapi_redirect.properties, uniworkers.properties, uriworkermap.properties, and isapi_redirect.reg files in the Native_IIS folder.

    Note: See the Appendix for sample workers.properties, uniworkers.properties, isapi_redirect.reg, isapi_redirect.properties, and uriworkermap.properties files.

  5. Create a folder named Logs under Native_IIS. Create two empty files isapi.log and isapi_redirect.log under Logs.
  6. Go to the Native_IIS folder, right-click the isapi_redirect.reg file, and click Merge.
  7. Click Yes on the message.

    The registry file is updated.

  8. Follow these steps and create an IIS filter for the DLL placed in Step 5:
    1. From the Windows Start menu, click Run, and then type inetmgr.

      The Internet Information Services (IIS) Manager window opens.

    2. Click the computer name and expand Sites.
    3. Right-click Default WebSite and select Add Virtual Directory.

      The Add Virtual Directory dialog appears.

    4. Enter jakarta for Alias. Enter the path for the isapi_redirect.dll file in the Physical Path field and click OK.
    5. Click Default Web Site.
    6. Double-click ISAPI filters and click Add under Action.
    7. Enter Tomcat for Filter name. Enter the path for the isapi_redirect.dll file in the Executables field.
    8. Click OK and the new ISAPI filter is added.
    9. Click Default Web Site and then double-click Handler Mappings.
    10. Click Edit Features and Permissions.

      The Edit Features and Permissions dialog opens.

    11. Select Execute and then click OK.
    12. Click the computer name and then double-click ISAPI and CGI Restrictions.
    13. Click Add under Actions.
    14. Select the path for the isapi_redirect.dll file in the ISAPI or CGI Path field.
    15. Select Allow extension path to execute and then click OK.
  9. Restart the IIS web server.
  10. Stop the MartServer service and start it again.

Note: See the Appendix for sample workers.properties, uniworkers.properties, isapi_redirect.reg, isapi_redirect.properties, and uriworkermap.properties files.

Implement SSL for IIS

If you have deployed Mart Server on IIS, you can implement SSL on IIS. SSL lets you access the Mart through a secured connection.

Note: This procedure describes how to enable SSL for IIS 6.0. If you are using a different version of IIS, see the relevant document on the Microsoft website for more information about installing IIS.

Follow these steps:

  1. Open Internet Information Services (IIS) Manager.
  2. Double-click Server Certificates and then click Create Self-Signed Certificate.
  3. Enter a name for the certificate and click OK.
  4. Right-click Default Web Site and click Edit Bindings.
  5. Click Add and select https in the Type drop-down menu.
  6. Select the certificate name that you have added in the SSL Certificate drop-down menu and click OK.
  7. Select Default Web Site and then double-click SSL Settings.
  8. Select the Require SSL check box and click Apply.
  9. Restart IIS and then restart Tomcat.

Note: If the validity of the certificate expires, create another certificate.